home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1998 January: Mac OS SDK / Dev.CD Jan 98 SDK1.toast / Development Kits (Disc 1) / Interfaces&Libraries / Universal / Interfaces / PInterfaces / QD3DStorage.p < prev    next >
Encoding:
Text File  |  1997-08-12  |  5.6 KB  |  143 lines  |  [TEXT/MPS ]
  1. {
  2.      File:        QD3DStorage.p
  3.  
  4.      Contains:    Abstraction to deal with various types of stream-based storage devices        
  5.  
  6.      Version:    Technology:    Quickdraw 3D 1.5.1
  7.                  Release:    Universal Interfaces 3.0.1
  8.  
  9.      Copyright:    © 1995-1997 by Apple Computer, Inc., all rights reserved.
  10.  
  11.      Bugs?:        Please include the the file and version information (from above) with
  12.                  the problem description.  Developers belonging to one of the Apple
  13.                  developer programs can submit bug reports to:
  14.  
  15.                      devsupport@apple.com
  16.  
  17. }
  18. {$IFC UNDEFINED UsingIncludes}
  19. {$SETC UsingIncludes := 0}
  20. {$ENDC}
  21.  
  22. {$IFC NOT UsingIncludes}
  23.  UNIT QD3DStorage;
  24.  INTERFACE
  25. {$ENDC}
  26.  
  27. {$IFC UNDEFINED __QD3DSTORAGE__}
  28. {$SETC __QD3DSTORAGE__ := 1}
  29.  
  30. {$I+}
  31. {$SETC QD3DStorageIncludes := UsingIncludes}
  32. {$SETC UsingIncludes := 1}
  33.  
  34. {$IFC UNDEFINED __QD3D__}
  35. {$I QD3D.p}
  36. {$ENDC}
  37.  
  38. {$IFC TARGET_OS_MAC }
  39. {$IFC UNDEFINED __TYPES__}
  40. {$I Types.p}
  41. {$ENDC}
  42. {$IFC UNDEFINED __FILES__}
  43. {$I Files.p}
  44. {$ENDC}
  45. {$ENDC}  {TARGET_OS_MAC}
  46.  
  47.  
  48. {$PUSH}
  49. {$ALIGN POWER}
  50. {$LibExport+}
  51.  
  52. {*****************************************************************************
  53.  **                                                                             **
  54.  **                                Storage Routines                             **
  55.  **                                                                             **
  56.  ****************************************************************************}
  57. FUNCTION Q3Storage_GetType(storage: TQ3StorageObject): LONGINT; C;
  58. FUNCTION Q3Storage_GetSize(storage: TQ3StorageObject; VAR size: LONGINT): TQ3Status; C;
  59. { 
  60.  *    Reads "dataSize" bytes starting at offset in storage, copying into data. 
  61.  *    sizeRead returns the number of bytes filled in. 
  62.  *    
  63.  *    You may assume if *sizeRead < dataSize, then EOF is at offset + *sizeRead
  64.  }
  65. FUNCTION Q3Storage_GetData(storage: TQ3StorageObject; offset: LONGINT; dataSize: LONGINT; VAR data: UInt8; VAR sizeRead: LONGINT): TQ3Status; C;
  66. { 
  67.  *    Write "dataSize" bytes starting at offset in storage, copying from data. 
  68.  *    sizeWritten returns the number of bytes filled in. 
  69.  *    
  70.  *    You may assume if *sizeRead < dataSize, then EOF is at offset + *sizeWritten
  71.  }
  72. FUNCTION Q3Storage_SetData(storage: TQ3StorageObject; offset: LONGINT; dataSize: LONGINT; {CONST}VAR data: UInt8; VAR sizeWritten: LONGINT): TQ3Status; C;
  73. {*****************************************************************************
  74.  **                                                                             **
  75.  **                             Memory Storage Prototypes                         **
  76.  **                                                                             **
  77.  ****************************************************************************}
  78. FUNCTION Q3MemoryStorage_GetType(storage: TQ3StorageObject): LONGINT; C;
  79. {
  80.  * These calls COPY the buffer into QD3D space
  81.  }
  82. FUNCTION Q3MemoryStorage_New({CONST}VAR buffer: UInt8; validSize: LONGINT): TQ3StorageObject; C;
  83. FUNCTION Q3MemoryStorage_Set(storage: TQ3StorageObject; {CONST}VAR buffer: UInt8; validSize: LONGINT): TQ3Status; C;
  84. {
  85.  * These calls use the pointer given - you must dispose it when you're through
  86.  }
  87. FUNCTION Q3MemoryStorage_NewBuffer(buffer: Ptr; validSize: LONGINT; bufferSize: LONGINT): TQ3StorageObject; C;
  88. FUNCTION Q3MemoryStorage_SetBuffer(storage: TQ3StorageObject; buffer: Ptr; validSize: LONGINT; bufferSize: LONGINT): TQ3Status; C;
  89. FUNCTION Q3MemoryStorage_GetBuffer(storage: TQ3StorageObject; VAR buffer: Ptr; VAR validSize: LONGINT; VAR bufferSize: LONGINT): TQ3Status; C;
  90. {$IFC TARGET_OS_MAC }
  91. {*****************************************************************************
  92.  **                                                                             **
  93.  **                                Macintosh Handles Prototypes                 **
  94.  **                                                                             **
  95.  ****************************************************************************}
  96. { Handle Storage is a subclass of Memory Storage }
  97. FUNCTION Q3HandleStorage_New(handle: Handle; validSize: LONGINT): TQ3StorageObject; C;
  98. FUNCTION Q3HandleStorage_Set(storage: TQ3StorageObject; handle: Handle; validSize: LONGINT): TQ3Status; C;
  99. FUNCTION Q3HandleStorage_Get(storage: TQ3StorageObject; VAR handle: Handle; VAR validSize: LONGINT): TQ3Status; C;
  100. {*****************************************************************************
  101.  **                                                                             **
  102.  **                                Macintosh Storage Prototypes                 **
  103.  **                                                                             **
  104.  ****************************************************************************}
  105. FUNCTION Q3MacintoshStorage_New(fsRefNum: INTEGER): TQ3StorageObject; C;
  106. { Note: This storage is assumed open }
  107. FUNCTION Q3MacintoshStorage_Set(storage: TQ3StorageObject; fsRefNum: INTEGER): TQ3Status; C;
  108. FUNCTION Q3MacintoshStorage_Get(storage: TQ3StorageObject; VAR fsRefNum: INTEGER): TQ3Status; C;
  109. FUNCTION Q3MacintoshStorage_GetType(storage: TQ3StorageObject): LONGINT; C;
  110.  
  111. {*****************************************************************************
  112.  **                                                                             **
  113.  **                            Macintosh FSSpec Storage Prototypes                 **
  114.  **                                                                             **
  115.  ****************************************************************************}
  116. FUNCTION Q3FSSpecStorage_New({CONST}VAR fs: FSSpec): TQ3StorageObject; C;
  117. FUNCTION Q3FSSpecStorage_Set(storage: TQ3StorageObject; {CONST}VAR fs: FSSpec): TQ3Status; C;
  118. FUNCTION Q3FSSpecStorage_Get(storage: TQ3StorageObject; VAR fs: FSSpec): TQ3Status; C;
  119. {$ENDC}  {TARGET_OS_MAC}
  120.  
  121. {$IFC TARGET_OS_WIN32 }
  122. {*****************************************************************************
  123.  **                                                                             **
  124.  **                            Win32 HANDLE Storage Prototypes                     **
  125.  **                                                                             **
  126.  ****************************************************************************}
  127. FUNCTION Q3Win32Storage_New(hFile: HANDLE): TQ3StorageObject; C;
  128. FUNCTION Q3Win32Storage_Set(storage: TQ3StorageObject; hFile: HANDLE): TQ3Status; C;
  129. FUNCTION Q3Win32Storage_Get(storage: TQ3StorageObject; VAR hFile: HANDLE): TQ3Status; C;
  130. {$ENDC}  {TARGET_OS_WIN32}
  131.  
  132.  
  133. {$ALIGN RESET}
  134. {$POP}
  135.  
  136. {$SETC UsingIncludes := QD3DStorageIncludes}
  137.  
  138. {$ENDC} {__QD3DSTORAGE__}
  139.  
  140. {$IFC NOT UsingIncludes}
  141.  END.
  142. {$ENDC}
  143.